image functions - continued

XgrDrawImageExtend  ( grid, imageGrid, startX, startY, endX, endY )

XgrDrawImageExtend() draws imageGrid in grid at the drawpoint.

(startX,startY:endX,endY) are pixel offsets into the image. The left and/or upper portions of an image is skipped if startX and/or startY is non-zero. If endX is reached, or imageGrid is exhausted before the grid-box x limit is reached, the final pixel is repeated to the grid-box x limit. If endY is reached, or imageGrid is exhausted before the grid-box y limit is reached, the final row of pixels is repeated to the grid-box y limit. If endX and/or endY is zero, endX and/or endY are set to the x and/or y limits of the image.

Drawing is not performed outside the grid-box.

XgrDrawImageExtend() is a relatively fast operation.

XgrDrawImageExtendScaled  ( grid, imageGrid, startX, startY, endX, endY )

XgrDrawImageExtendScaled() draws imageGrid in grid at the drawpoint.

(startX,startY:endX,endY) are pixel offsets into the image. The left and/or upper portion of an image is skipped if startX and/or startY is non-zero. If endX is reached, or imageGrid is exhausted before the grid-box x limit is reached, the final pixel is repeated to the grid-box x limit. If endY is reached, or imageGrid is exhausted before the grid-box y limit is reached, the final row of pixels is repeated to the grid-box y limit. If endX and/or endY is zero, endX and/or endY are set to the x and/or y limits of the image.

Drawing is not performed outside the grid-box.

XgrDrawImageExtendScaled() interprets image data as scaled coordinates, therefore it will zoom (enlarge and compress) images of drawings, icons, and video images.

XgrDrawImageExtendScaled() is a slow operation.